home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / viewers / tgif11 / tgif11.doc < prev    next >
Text File  |  1990-04-19  |  7KB  |  140 lines
  1.      --------------------- TGIF  Version 1.1 (Beta) ---------------------
  2.      GIF File Utility.  
  3.      Gif is copyright of CompuServe, Inc.
  4.  
  5.      TGIF (for Thank God It's Friday, I wrote this code on weekends)
  6.  
  7.      Version History:
  8.      Version 1.0 released              April 16, 1990
  9.  
  10.      Version 1.1 released
  11.               Fixes bug in the save program which caused one in every 
  12.      128 GIF files saved to be terminated improperly.  This new save 
  13.      program has not been observed to fail. 
  14.               Fixed bug in histogram routine so that the gray scale is 
  15.      expanded to the full range of black to white.
  16.               Fixed Bug in Gray Conversion routine which caused all 
  17.      pictures to be weighted 100% blue. Added code to adjust 
  18.      red/green/blue weighting for gray conversion.
  19.  
  20.  
  21.      Tgif allows you to view GIF pictures using a VGA monitor. However, 
  22.      picture viewing is not what TGIF is intended to be used for. TGIF is 
  23.      a graphics utility which allows you to:
  24.               
  25.               o Cut a portion of a GIF picture.
  26.               o Convert a picture to a "Black and White" grayscale image.
  27.               o Perform image sharpening.
  28.  
  29.      TGIF has a very simple interface.  My original (unreleased) version 
  30.      of TGIF was very fancy, sort of like one of the better GIF file 
  31.      viewers. However, because of the requirement that the picture be 
  32.      retained in memory while operations were being performed on it, very 
  33.      large GIF files could not be loaded due to the large size of the 
  34.      program itself.  The nice interface was sacrificed for greater 
  35.      utility. I also changed languages, finding that Assembler was faster 
  36.      and resulted in much more compact code.
  37.  
  38.          TGIF is started by typing TGIF at the Dos Prompt. This does not 
  39.      erase the screen so that you can do a directory first to identify 
  40.      the file you wish to work on. TGIF then request the name of the GIF 
  41.      file.  After this is done, the TGIF main menu is displayed.
  42.  
  43.      TGIF main Menu:
  44.          1) Show GIF Characteristics   
  45.          2) Display the Current Picture
  46.          3) Load another picture
  47.          4) Cut a portion of the picture
  48.          5) Convert to Gray Scale
  49.          6) Save the Picture
  50.          7) Quit the program
  51.  
  52.      Function 1 shows all of the information about the picture that is 
  53.      available in the Screen Descriptor and Image Descriptor. 
  54.  
  55.      Function 2 only works if you have a VGA monitor. In a later version, 
  56.      you will be able to display the picture on an EGA monitor, also.
  57.  
  58.      Function 3 frees the memory and loads another picture. This has 
  59.      little added value, in my opinion, but the added code was not great 
  60.      either.  I plan on using it later.
  61.  
  62.      Function 4 Cuts a portion of the current picture to make a smaller 
  63.      picture. VGA is required, as in Function 2. A mouse is optional and 
  64.      is very useful. If the mouse is not used, then your cursor is this 
  65.      tiny little dot that moves SLOWLY across the screen.  The cursor is 
  66.      moved with the arrow keys on the keypad . If you have a Microsoft (tm)
  67.      or Mouse Systems (tm) mouse then you can move rapidly across the 
  68.      picture to the area that you wish to cut. If your picture is bigger
  69.      than the screen, move the mouse to the edge of the screen in the 
  70.      direction in which you wish to go. A new area of the picture will 
  71.      then be displayed. 
  72.          NOTE: I have observed a bug in this Function. I developed this 
  73.          program on a DTK XT-clone with a no-brand-name VGA card from JDR 
  74.          Microdevices, and a Genius GM-6X mouse. The program worked fine. 
  75.          I then tested it on a Compact 286 with a Orchid VGA card and 
  76.          found that my (MicroSoft) mouse travel was severely limited! I 
  77.          put a fix in BUT now it seems that my mouse cursor jumps around 
  78.          SOMETIMES. I haven't be able to isolate the cause due to the 
  79.          nature of the CodeView debugger.
  80.           
  81.      Function 5 converts the picture to Gray Scale. The initial weighting 
  82.      of Red, Green and Blue is 5 parts red, 9 parts green and 2 parts 
  83.      blue. I choose this color weighting as the initial values because 
  84.      it is similar to the gray conversion performed by the VGA bios.  
  85.      The color weighting can be adjusted by using the arrow keys on 
  86.      the keypad. Right Arrow incresses a color (and decreases the 
  87.      color below it). Left Arrow decreases a color (and increases the 
  88.      color above it). The up and down arrows change the current 
  89.      color(s) being edited.  
  90.  
  91.      Function 6 Saves the picture. This saves the picture that you have 
  92.      in memory as a GIF file. It is very slow, and this is after I 
  93.      speeded it up some! It has a bar graph to show you how much of the 
  94.      saving is done, in case you are one of those people who think that 
  95.      their computer has quietly crashed and didn't bother to tell you 
  96.      that it has become confused. 
  97.  
  98.      Function 7 Quits, and returns to the Dos prompt.
  99.  
  100.      Once you have converted the picture to a Gray image, (Function 5) 
  101.      you can get the following functions from the Aux menu.
  102.  
  103.      Function 8 Sharpens the picture by LaPlacian subtraction. Sometimes 
  104.      this makes the picture a little better, sometimes it'll bring out 
  105.      more detail, and sometimes you'll wish that you hadn't done it.
  106.  
  107.      Function 9 Doesn't work yet. It takes the picture and converts it to 
  108.      the frequency domain using a Fast Fourier Transform. From there, 
  109.      it's going to get complicated, as you can do spacial filtering.
  110.  
  111.      Function A Counts the occurrences and draws a weighted histogram of 
  112.      the picture. From the Histogram you get a mini-menu, 1 will return 
  113.      you to the Main+Aux menu. 2 will expand the gray scale so that the 
  114.      darkest gray in the picture is black, and the lightest gray is white.
  115.  
  116.      Function B and C doesn't work yet either.
  117.  
  118.      In the future, TGIF will allow you to:
  119.               o Do Histograms of COLOR pictures.
  120.               o Save pictures in another format.
  121.               o Sharpen COLOR pictures. (Tough one.)
  122.               o View and cut in EGA mode.
  123.               o Work on Multiple image GIFs
  124.               o Create Multiple image GIFs from single/multiple image 
  125.                 GIF files. 
  126.               o Save files as interlaced GIFs (I hate interlacing!)
  127.      
  128.      I would like to hear from anyone with a VGA compatibility problem 
  129.      or any other problem that I haven't mentioned.  For example, to 
  130.      draw the picture, I directly access the memory area at segment 
  131.      A000 using MOV commands. This is not stictly the VGA standard. I 
  132.      would be grateful to hear if this method does not work for 
  133.      everyone.
  134.  
  135.      Steve La Joie
  136.      Amature Programer
  137.      GEnie Mail S.Lajoie
  138.      Prostar - FRESNO
  139.  
  140.